Billings Types
APIO supports multiple billing types that define how often a subscription is charged.
Each billing type represents a fixed time interval after which APIO automatically generates a new charge for an active subscription.
Billing types are standardized across the platform to ensure predictable billing behavior and consistent subscription management.
How Billing Types Work​
When a subscription is created, a billing type is assigned to it. APIO uses this type to:
- Calculate the next billing date
- Generate expected charges
- Trigger payment processing through the selected payment processor
- Maintain a consistent subscription schedule
Billing types are internally represented using fixed day intervals, which makes them deterministic and easy to reconcile.
Available Billing Types​
| Billing Type | Identifier | Interval (Days) | Description |
|---|---|---|---|
| Single Payment | single | 0 | One-time charge, no recurrence |
| Weekly | weekly | 7 | Charged every 7 days |
| Biweekly | biweekly | 15 | Charged every 15 days |
| Monthly | monthly | 30 | Charged every 30 days |
| Bimonthly | bimonthly | 60 | Charged every 60 days |
| Quarterly | quarterly | 90 | Charged every 3 months |
| Bi-yearly | biyearly | 180 | Charged every 6 months |
| Yearly | yearly | 365 | Charged once per year |
Single Payments​
The single billing type represents a one-time purchase:
- No recurring charges
- No subscription renewal
- Commonly used for one-off products or services
Important Notes​
- Billing types are based on fixed day intervals, not calendar months
- A monthly type is always 30 days, regardless of the calendar month length
- Yearly billing always uses 365 days
- This ensures consistent charge dates and simplifies reconciliation
Best Practices​
- Choose the billing type that best matches your business model
- Use
singlefor one-time purchases - Prefer
monthlyoryearlyfor long-term subscriptions - Clearly communicate billing frequency to your customers